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, CP“67/CMS User’s Guiae (GU2u~0659-1) 

- CP~67 Operator's Guide (0020-0356-1) , 
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(Gil2Q~1uLg-0) — NLW-- 
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' y ■ . . 

CMS Vetsioii J. 1 includes tiie toiiowiiiy system retiiieui'euts: 

Instailcitica ot Release 20 oi the OS iaayuaye processots-- 
r- Asseiiiblur, FORTRAN, PL/i« 

Upytadlay aua ext'atisioii oi tue siittuiatioii ol OS tunctions to 
insure proper operation or the iahyaaye processors and tne 
correct execution cr tne resultant oDject coae. 

Reef data error recovery routiiies accocaiiiy to Type I 
Speciricatious. 

Design changes 

Ccmniands . 

New naming convention tor source routines wnereny name 
connotes operation and relatioiiship to^otner routines. 


CP-fci7 Version 3 revai 1 contains the ioiiowing iBaintenance and 
periorniance improvements, • - 



improved sub-routine linkages lor heavily used 
routines via fcALR - 

Modify page seiection aigocitam to use rerereuce 
b it. 


Re-coding of scheduler (DisPAToh) to reduce 
me triCiencies. 

( 

Eliniination or SCAN macro tnat generates SLT 
fiPQ iustructioa, 

/ Support of CMS file i/0 by using DiAGNGSE. 

Support or oiiS dynamic page release by using 
DIA GNUS £, 


Upgrading or system ana user statistical gatnering, 

Re-coaiug ct IRUGINT ror a better scheduler interface, 

Multiple page reaa/writes on tne 2301 drum wnere 
■ possible, 

Miscellariecus changes, 

n 

Serviceanriity functions. 
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1. LAi>iGUAGiL PoOC Ed bOKS 

In Vdcsion 3.0 CtlS oa^poctea three uS/JoO iau^udye ptocesscra: 
ASSErtdLiH (l<ei. 0} , tOrf i’Saw (toiaprier-ixei* 14, Lroraty-Hei . Id) , EL/I 
(Eel, To) , for Veiiiion 3.1# arr proceiasors uua supporting 
liht'dries are upgraded to U3 release id. 'due ouject (TEXT) decks 
cr aii cctuponents or eacn processor were obtained by assembling 
tne source code acgurrea xcom PID. raeii, an EXEC procedure 
(-GEND) was written to create a moauiar overlay structure tor each 
processor# e.g.# FOhGEKD tor FOal’hAw, r/pe I component code has 
been moditieu cniy where uecessary to interlace with CMS or to 
correct a severe error in tne type I coas, huch mouilicat ions are 
documented in cue instaliatioa Guide, GhdO-udb?. 

Ifae CM3 ianguage-processoc rutertace routines, uetermine the 
read/write disk with the most available space, ana use that disk 
to maintain its utility data sets during processing, by correcting 
the problem with tne FILsdEf command, tue user uas an 05, JCL-type 
capability to define the ciiarac terist res or a data fiiei 
biocksize, record ieugtn, 'record format, resident device type, 
Fcr example, a user aiay reguest an output file on tape, disk, 
console, punen, or printer, ■ . _ ' 


The PL/I compixe.c (release iu) uses a different iinkage to Library 
Subroutines than dia previous releases. rherefore, if,..-the release 
20 Subroutine Liorary is to be used, user programs must be 
re-compiled. 


o 
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-• 03 j I tiULii i'luN Uft Ja it GftJ 

In order to 'Support tue US iuuyuaje ^roceiisors, diju the ijeuerdted 
object code, sxinulatio n under crtS ti«is ueen expandeu. When a 
processor or a usex-wrrttea proyraia rs executriig and utiiiziny 
U’S-type tunctioiis, US rs not overseeing tnrs action, CWS is ru 
ccntroi. Conseyuentiy, rt is not OS T.ype I code that is in CMS, 
cut routines to simulate in teriBS or CdS certain essential OS 
functions. 


Ihese functious are siauiatea to yield tne same results as seen 
frcm the processing program, as speciiied by US program icyic 
manuals. However, they are supported only to the extent stated in 
CMS docuiuentation and to the extent necessary to successfully 
execute US language prccessoxs. i'he user should be aHare that 
restrictions to OS functions as viewed from OS exist in CMS, 

The OS functions that; CMS will simuiate are; 


MACHO SVe , 

^tie jumper Comine nc s 


^XDAP 

u 0 

WAIT 

01 

POST 

02 

■‘HETUHN 

03 

GET MAIN 

04 

FHEEMAIN 

05 

LINK 

Ob 

XCTL 

C7 

LOAD 

08 

DELETE 

09 

GETMAIN/ 
fHBEMAIN 

10 


1 1 

ABEND 

13 

^SPIE 

1H 

*bLDL/fINU 

18 

OPEN 

19 

CLOSE 

20 

^STOW 

2l 

OPENJ 

22 

TCLOSE 

23 

^DEVTXPE 

24 

*WT0/WiaH 

35 

^EXTHACT 

40 

♦IDENTIFY 

h 1 

^ATTACH 

42 

^^»CHAP 
' ^TliMEH 

44 

4b 

*STIMEH 

47 

*DEU 

48 


caired wnen a cowprl'er uses XOAP 
wart' ror an 1/U compietron 
post tne ^/O coiiipietioa 
return rrom a LiNK-to routine 
conaitionaiiy acguire user tree storage 
release user-acguired free storage > 
iiux control to another load phase 
delete, tiien iiiiK control to another load phase 
read xnto core another load phase 
.delete a ioaded phase 

iaanrpaiate user free storage 
yet the time of day 
anort processing, ana enter bsBUG 
airow ijrooiom program to rutercept program 
interrupts 

maurpuiate simuiated partitioned data files 
activate a data rile 

deactivate a data iiie ' . 

mainpuiate partitioned directories . 
activate a data rile 
temporarily deactivate a data file 
obtain device-type physical characteristics . , 
communicate with tne coasoie • 
effective NUP 
elfective HOP 
eiiective HOP 
effective HOP 
eriective hop 
effective HUP 
eriective hup 
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AbDUMP 

‘J 1 

(isaiiiu ii;* 

♦'INW 

‘j U 

ut it*c 1. x ya iU)i‘ 

FWttDLiUF 

1)/ 

release a tree :.toi.age bult.u 

■cStab 

bO 

allow processing program to Uecrpher 
abort condition 

*DFTACB 

b2 

etrective hUP 

#CllKPi' 

bJ 

efrective MOP 

♦KDJFCB 


obtain inlormation from FILBDBF command 

^SYMAD 

6d 

nandie aata set error conditions 

^EACKSPACB 


nackup a record on a tape or disk 

GEI/Pdl 

.« 

access system-blocked data 

RhAD/WaiTB 


access systeia-recocd data 


«-siauiatea in tne transieiit routxae **apS7CTH'V. 


The aani[:ulation of , data is yoverued by au access method. To 
facilitate the executicu of **us Code” uuder CdS, the processing 
piogEam must "see” data as Oh would present it. for instance^ 
when tne processors expect an access method to sequentially 
acquire input source cards^ cdS lavoKes its sequential access 
method and passes data to tne processors in the format that the OS 
access methods would have prouuced. Thererore, data appears in 
core as ir it nad seen manipulated using an OS access method. for 
example, bloci descriptor words (JUDW) , buffer pool managemeat, and 
variable records are maintaiued in core as if an OS access method 
had processed the data. The actual writing onto and reading from 
the I/O device is handled by CMS file manageffleat. 


The worX of the Volume Table of Contents (VTOC) and the Data Set 
Control BiocK (DSCB) is done oy a master file Directory (MFD) to 
maintain disk contents and a File Status Table (FST) for each data 
file, respectively. All disks are formatted in physical blocks of 
829 bytes. 


If the filemode number ci a speciiic data set is set to four {;), 
CMS will maintain the OS format within its own format onto the 
auxiliary device. That is, the olock and recora descriptor words 
(BDW ana RDw) are written aioug with the data; if a data set 
consists of blocked records, blocks are written at a time, not 
records, if the filemode numDer is not 4, CMS will aeblock or 
enoiock records so that the CMS format will be maintained on disk 
~ regardless of how the problem program nas written or read the 
data. 


CMS Will also simulate the specific methods of mauipuiating data 
.sets. A data set may be accessed: 

directly — identifying a record by a Key or by its relative 

position Hitain the data set . ■ 

partitioned — seeking a namea member within -an entire data 
' -set ■ ' 




; • . . PAGE B 

o 

seijuentidii^ -- dccesso-uy a recotd iii a 

oi: toiio»iag 

CW3 kfiii also simulate pottioiia ol coiitcol blocks used by OS to 
'sustain a ptoytdui auriny execution, bach blocK. will be docuinented 
in detail as to wLicn siots ate maintained by ChS and which are 
used under OS, Tne controi nlocks are as roiiows; 

CWSCV'i Simulates tne Communication Vector Tatle. 

nocariou 1b wiil contain tne address oi the 
CVI coiitroi soctiou. 


sequence relative to 
items. 


CHSCn 


i.s carved out oi system Iree storage whenever 
a llnEDbf command or an OPbii (SVC 19) is 
issued lor a data set. Tue CiiS Control Block 
consists oj. a file Controi bIock. (FCB) for the 
data tile ana siitiuiation oi the Job file 
Control Bloc/t (JFCii)> latul/'dutput Block 
(iOfi) ^ and Data bxtent Biocx (DEB), Ihe name 
ol the data' set is contained in the FCB, and 
is cbtaiued from the FILEDEF aryumeut list, or 
from a predetermined file name supplied by the 
processing prpulem proyraui. 


•o 
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Ex-jCOC recovoiy lor dxsA aua ^i.iutyL i/u Oi^etatioas has been 
consolidated into a cominoa etior aandiiny Loutiue. The routines 
attected ace desccioea beioi^. 



PUfiPQSE; lOEafi is a tanle processriij proycam providing cas bith 
centraiizea I/O error recovery. I'ne devices tor waica recovery is 
provided are tne 2311 ana 2 j 14 airect access storage devices and 
the 1403 printer. 

MC DU LESS XOiiKaSlJP, lOEEixEC, iOsLiiCiSS, iOaUTAb 
C^LED_3Y: diSKiC, PEXhiiO 

dEN£«AL_OPEhaXiUN: isneu eituec PaiariO or DiSKiU 41 .e,^ the system 
routines tnat periorm the i/u opeLatioas on tae aevices supported 
by error recovery) enccuaters an i/u error, a parameter list is 
built in rree storage ana lOEititSuP (the error recovery interlace) 
IS called. jlOEhhSUP inirialires its tree storage (containing a 
trace table tor deDuggiuy, a ' aaiT parameter list to synchronize 
the error recovery 1/U Gperatrous, and a read Irst tor bringirig a 
copy ot iUMUXab into tree storage ri necessary;. iUEhhSUP then 
replaces the device's standard interrupt processing routine »ith 
EBPhINTD (the error recovery interrupt processing routine). 

it the ettor occurred during tne initialization or the operation, 
SiUEflRT IS entered, it tae err 01 occurred during the completion of 
the operation, ciOERhi is entered, 

S10ES3T contains three routines corcespouding to the three 
possible errors auurng 1/0 rnitiation. SlOSUbi aaits ior 'the 
chanual or subchannel to become avii-iabie and returns to either 
PKINTiU or DlbKlO. SIGNUIOP (not oijerational) calls lOEbaHES to 
type dll error message, aau returns to either PhlN'IiO or DISKIO 
With a not-operationai return code xn register 15. biCCSM 
(channel status word stcreu) does one or four tuiugs depending on 
the condition causing tne CSR to be stored. if tne device is 
busy, 31031)31 is euterea. ir tae aevice contains a pending 
interrupt from a previously completed operation, SlCCSri 
initidliZGs the . return coae to indicate to PHlhliO or DISKIO that 
■the device is now availauie ana eutets CLEAhOP, It the started 
operation caused an error, CuOEhnr is entered. 1 -t the started 
operation is an unchainea . immediate coinaiaud and the immediate 
operation is eiror tree, uoriuai ptocessiny continues. However-, if 
the immediate ccmmand causes an err 01 , the routine^containing the 
I/O operation enters EHR3DP. ■ 


CiOEhHT contains lour loutines. ciOoUlES (guiesce 1/0) analyzes 
the macuine's state on entry into error recovery. CIONliCK (unit 
cnecK.) pertorms a sense operation if a unit checit has occurred. 
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RTLOAOiiit initidiize^ tue uevice cyye tdDle (iOwUlHii tor direct 
access, the copy ot xUNUi’iib xu xree storage cailea iuFhXAtj tot the 
printer), and passes ccatrui to lUfiRREt, lOEahEo searches the 
device type taxie tor tne error aua executes the routine tor the 
recovery actxon. Wiieii coiaj^xetea, xOERREc exits to i:<'i’hO.ADEfi. When 
a pertaaneut 1/u error has occurred, KiLOAOEh caiis lUSRRdES. With 
"a successtur recovery, hTLUiiDER exits to CLEAhUP. CLEANUP 
releases tree storage ana returns to e-ltner PiixNilO or UiSKlo viith 
register 15 containing tne status oi the operation and/or device. 

during error recovery, interrupts iroui tue device xu error are 
processed Ey EatiNID. 


DxSKlO a nd P HINil0 

IrU fP OSE: I/O operatiuiiij drrocteu to tne 2J11 or xJl4 direct 

access storage device are p>rocessed dy drSKlO, Upon a start or 
ccmpietion error, diSEIu huxxds a. jjardiUeter list ror lOERR to 
attempt error recovery., uii rexurii irom iOERR, DiSKiO analyzes the 
return code. PfilNTlO haudies error i /0 operations which' were 
directed to tne 1 403 printer lii tne same way. 

ENTR Y CONDIT ION S: (when Cdixiag xOxRR) 

V ' . , ■ . 

r1: nduress or PxiST' 

rl4 R-Otarn auuress in routine containiug 

tne I/O operation in error 

r15: rtuaress ox iOERRSUP 

EXIT C O NDxTl ohS: (ou return Irom erxer recovery) 

r15: return code . . 


OPER A TIG N: wnen erther a start ox compxetxon I/O error occurs, 
CiShIu (or PKiNTxO) issues tue EioPu macro to (1) obtain tree 
storage for the parameter list, (z) buxid the parameter list by 
using the CSw, I/u old t5«, and liii or matron trom the device table 

in NUCON, (3) set a nag xnaxcaLiiig it this is a start or 

cciBpleticn error, and (4) eater xOEuusuPo 

On return from iuERRSUr, uiSKlu 401 PRiNIXO) analyzes the return 
code. If the recovery was successfuf, DISRiC (or' PRINTIO) 
releases tree storage and returns to tne caiiing program. If 

register 15 contains X'ux' (uevice now avaiiabie) , DISKIO (or 

PRIRTxU) releases tree storage and retries tne opeca.tioa. If 

.Register 15 inaicates a permanent 1/0 error, DiSKIO (or PRINllO) 
eieases free storage and returns to the caiiing program with 

register 15 laaicating a permanent I/O error, . ^ 








PAGi 1 1 


10 lj UTA ij a nd Lon'h'LkB 


13 d taijie coxitdiniug tae recovery procedures 
and error inessdyes by aevrce t,pe duu error. ^ Procedures 

ore tfeo co^^^ies- ot loNUbaB. One couv. lUfHTAK , - 
nucleus resuueut, eul u2eriorSA.u‘':rracs!“"‘’"- 
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4,’ Gci_CiiA NGES 

. Lojicai syiitGni jLiiiptcveiueuc.^ duct lacredtied execution elticiency 
iifere achieved by aiteiiny seveidi xey nucleus routines, 

IhlSVC - Supervisor Jail Interrupt hanaier now periorms raster for 
less cede• 

CMSCASS -Tnree miner commands nave neeh taken out oi the nucleus, 
tnus saving core, ana yrouped toyether with five new 
cciuiuands iji a transient module called CtlSCAHh, The 
cemmands become aryuments to one yeneral coBimaiid - VSET® 
Tnese cemmands are; 


BLIP - sets blip cnaracter 

CHhisDEF - defines loy icar ruuction cnaracters (tabset, 
backspace, hex representation) 

IMPsX - sets tne oraer of search for commands 

nDhi'bLS “ sets the numner or reservea core payes for 
loader tables 

L1h£uD - defines tne logical end-or-aata return 
character 


HD^dSG - determines tne lenyth ox the ready message 

fiEOi’YPji - ir so eydipi^ed, cue user's terminal will type 
ail eiroi messages in red 

hbsPiiG ~ releases (or retains) contents of core 

file mode numbers can now range xrom 0 to d; 

0 - tile IS private to use® of read/write 

but is not available »aen tne disk is • 

read-only, 

1 or 5 ~ file may be read or written. 

2 or b - tile is read only. This is not 

currently implemented. 

3 - file may be read or wrrtten, but is 

erased when tne rile is closed. 

^ 4 ~ reserved tor OS simulation routines 


It is not necessary to login a uisk to function within CHS, 
Tne ''LOGIN (NO-DISK)" will pass control to the initialization 
routine (iNiT) without beuaiit of a Primary aisx. 





Aii cousoie Loutiiicci uave ueeu mdati ireentraut code, aiiowing 
theai tc uecciae a patt ot tue iocKed-saacad payes. 


Betore euteLiny the wAii' stata and lorcany tue user to effect 
an dtteiiLioa interrupt, INITBo? and INii’IPi. wiii assume the 
teiminai adarees ra A* 00 y* or a' 01 F‘. 

Use will be made of iowcore iocatrons; (aii nex addresses) 

C ore Locat io n hu moer or Byt es 


10 
Id 
84 
8 0 
8 8 
A 0 
Ad 
AC 
BO 

i)0 

F8 


4 

4 


12 

8 

8 

8 

4 

4 

15 

*40 


a 


A (Coaaiuaicatiou Vector Xabie) 

H (SVS8BF) 

CP's BAVESYS, vectors 

Udute of com maud oeiuy execu ted 

real date (mia/dd/yy) 

real time (nh.am.ss) 

idtest reading or virtuai CPU time 

iatest reading of real CPU time 

version ideutificatiou (15 chars*) 

inStaiiation neadiny (40 chars.) 

named system that was IPs®D 


. hearrangeineiit cf nucleus foutines to laaintain a more orderiy 
and efficient design tc'tue system £iofe' or controi. By removing 
work areas and piaciiig tnem into pages 0 and 1 , more routines are 
made shareauie. Also, auen analyzing a core dump, the current 
system status may be determined by data centrally located in pages 
3 and 1 in ttie teocxing sections hUCoh, INrBECi’, NUBECT. 


. iha CUB modules DrSKIO and PRIiJIIQ noi»' employ the technigue of 
reguesting I/O cperations via cue DiAtiliOBE command —• code X*18*. 
This is used lor records of 800 bytes or less. Otherwise, a 
nocmdi BIG couiiaana is used. fuis technigue ,allows CP-b7 to use a 
standard CCw seguence, tuereby eliminating the overhead of CCW 
translation, BIG simuiation, etc. CP-b7 will return a condition 
code indicating successiui or unsuccessiui operation, CMS vili 
perform error recovery. 

X/0 operations requested via tne DIAGNOSE command are not 
overlapped ^wich virtual macnine processing. Control does not 
return to CMB until the operation is compieteu or an error is 
detected. ■ 

. Cyi u track 0 record j of a user's disK may contain an 
identitying lacei, when formatting the disk, or anytime 
thereafter, ny using "rUEMAl d L”, the user may write a b-fcyte 
label. The command "S'ial?" types the disk label to the console 
and "OFFLINE PUNCiiDi' filename fiietype" places the label in-the 
punched OFFLINE BEAD control card. • . 
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5, cgwiiMi^ 

' CCfiBINii “ Mew Paraffleters ot = aau * 

Nefe u;^ticus 

'' r» ' ' I , ' 

fuigose; ‘ ^ 

The COMdlMii; coBiinaiiQ joaus two oa more dii;k faaes iuto a single 
file# moves Tiles becween disks# and changes file designations. 

Format; 



I COMBiiiE ! Ufa nit aim oinl ofti oimi ,,, oiaN ofttt ofmN (OPTIONS) ] 



ain aft ntm are the filenaise# filetyge# and fiieuiode oi tlie file 
to be created. • . 

otn oft otm ate the filename, filetyjja, fiieuiode of existing 


/"^if ile (s) to be included in the xiew file. 

= for nfn Kill adopt oinl (same iiiename) 

= for nft will adopt ortl (same fiietype) 

= for nfm will adopt aiml (same iilemode) 

^ for ofni means all lileuames 

^ for ofti means ail riletypes 
* for otml (not accepted) 

O ption s; 

TYPE - wiii type ofnl or ortl if an asterrsK is iu either 

field. • 

NODAXE’- makes the new creation date and time the same as the oid 
file. 

‘x ■ 
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Usa^e: 

The tile to oe cireated aua eacu ot tue incidded ixies must specify 
filename, tiletype, and fiieaode or one of the ahove opticns, 
input files must nave tiie same record format (fixed or 
variabie-ieu>jth) . input flies oi-rixed length records must have 
the same record ieuyth. nay namiJei; of input files can be included 
in the new file, in the order uaiaed, but tne command must not 
exceed a single input line, ■, 

■ ^ ■ ' ' ■ 'n . ■ ■ ■ • . 

The output file is created ou the specified disK. according to the 
mode letter of the new fiie. input files may be on any read-write 
or read-cniy diSK. that is logged in. 

It the new filename, fiietype, and fiieiuode are those of an 
existing tile, the old file will oe erased when the new file is 
created. Ihe old file may be among tne input iiies. 


Kotes; , 

a. Files may not be copied to the system (SY) disk,. 

b. As the input files 'ate p'rocessea, a temporary work. rile is 
created with tne identifiers (TdilP) (FliiS) mm, where mm is 
the specitieu mode of tne output fiia. slaen processing is 
cofflpietea, this tile is given tlie aesignatiou specified for 
the output iiie. ii aii error occurs such tnat input files 
ate destroyed, records can he retrieved from tois work rile. 


Respo nse s: 
done. 


Err or Me ssages: 

1. inyALlD PAfi'AdEi’hu LIST. 

Invalid set of parameters enter.-'d. 


2, X - DISK KOT LOGGER ih. 

bisK is not logged in for moue itjeciried m output file. 


3. X - DISK ROT id wrill'E STATUS. 

Disk is not in write status for moae specified in output 
fiie. 


U 


INPUT ElLi; DUES. NUl EXISl. 
input iile specified not round. 







PAG! 1b 


."IbAGA wtii'i'ii'iG UL/TPL i u A Ui bK. 

All I/O eiLor occui;i.ea or Liiu aaer'a diiottoci diSA space is 
fiiled, 

EHdOa T£<Ii.i!jO 10 OUl’PU'X sxLB. 

Aii_ error .^as recurned rroai •ALi'Eu* tryra-j to alter the output 
i X1 e c ' • 

1 ” DISK Nor LOGO S C Ixi* 

Disk is not iogyeu xu tor iHOde spectried in input rite, 

k - Invalid iiodl fok uurpdi .fill 

Mode speciixcu tn output txie not supported* 

AiriMPI iO COdBlNL xIaLD j-LNOTu aND VAHiAaLL LENGIh flLES# 

X li'iVA'LlD MODL FCn iNPUI .FILL 

Mode Sped tied in input tj^te not supported. 
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Purpose: 

Ehe FIL2DEF coiiinidnd prcvraes aevrce iudepetidence by ailoaing the 
user to speciiy the ruput/output devices as weii as certain file 
characteristics to ue used by a prograiU at execution time. PiLEDEF 
bay also be used to moaity, aeiete, and list current file 
definitions. 

Format: ' 

To list or clear data deriuitioas; 


I .FILEDEF 1 <tileid CLEAh> j 

i I * I 

fiieid the name oy which, tne rile is referred in the user's 
program. For FUhXixAn, tars is the data set reference 

number; for the Assembler, tne adname or the DCB; for 
PLl, the ddname or the i)CB; and' for the language 
processors, the assumed riietype -- e.g,, TEXT or LISTING, 

* means all fiieids (see the PEhii option for an exception). 

CLEAN • the file definition for the fiieid specified is to be 

cleared. 

Nith no operands, the FlrEDEF command types a list of all current 
file definitions. 

Once a file ueiinition has been set up, it may be deleted with the 
CLEAR operand. ■ CLEAR deletes the definitiou tor the fiieid 
specified, if au asterisA is speciried, aid deiinitiohs are 

deleted except those detinaa with the PERM option (see the 
description below) . files uerined with the PEaci option must be 
cleared individually. 

To relate a tile to a device; 


I FILEDEF I fiieid device <parms> <(options> j . 

device speciries the iaput/output device for the file. Device 
must be one or tne foliowiug; . 

CGN User’s teraiinai 

DSK , Disk - 

DSK-inm Disk witn speciric mode 

UOMtti uumniy device for waicn no actual 1/0 is to occur 
PRT Printer 
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Card puncii 
Card reader 

Magnetic tape (ii must be dlaaK or 1 or 2) 

patms are the uata a«d trie cndracterrstrcs. iite valid parras 
depend upon the ae vice named. These are aerined under the 
Specific devices. 

Op tion s: 

P£BM specities that this definition is to remain in effect until 
cleared by tiieid CLEAh. 

SOCHANGE specifies that tne file definition is to be set up 
unless a uetiiiition already eiists for the fiieid. If a 
aefiaition exists, the ola one is retained. 

Osage: 

To set up a file definition, beta tiieid and device must be 
specified, ’ 

4 ■ 

k DUMilf device may be used at times wneii no I/O is fefanted -— e.g®, 
for program testing, 

depending on tne device specified. 

The file characteristics tuat may 
'beioa With the devices to which they 

These devices reguite the parameters hECfil, bhECL, ana 8LK8IZ* 
devic e hECFM LEE CE 8 LhS I‘Z 

13J 133 

8 0 30 • . 

8 0 3u 

The metaod of changing these is described under TAP, 

CCH 

The only valid parameters ror CON are CASE, aECFM, LEECL, and 
BiKSIZ, If none are specrfred, the defaults are used. 

CASE iOdER specifres that console data is not to be translated to 
uppercase, it CASE LOWER is not specified, console 
I/u is translated to uppercase, 

TAP 

Xhe only valid parameters for TAP are EECFM, LRECL, and BLKSIZ, 
For seven-tracA tapes, MODE may be speciried. 


PET f 

PUN F 

KDE F 


parameters may be necessary, 
be called tor are described 
ace appropriate. 


PUN 

nDR 

TAPn 
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lo eutec useL Vdiues lOi. htCrii, LKiGL, aua bLKSi^, qiidutities are 
specitied in pairs: name or pacameter, cnen speciric vaiue. 

RECFii toruiat speciries cue rocora iormat for tije tile. format 
must be one or tiie' toiiowiiuj: 

c i'ixea uuniooKea 

f'b Fixed oiocxed 

V VariaDie unuiocxed 

Vli Varianie blocked 

U Uaaetiuea 


IHECb nn 


specifies tie logical record length in bytes, 


BIKSli an specities thu blocit sire m bytes. 

For seven-tracK tapes, a MODE may be deiiaed. 

MODE an specities the mode aumber uosired troni tne chart beloa. 

Note that 1 - 5 are tor dOJ BPi, o - 1e are ror 556 EPI, 
ana 11-15 are for 200 bPi, 


20 0 . 
BPi 


PAKlif CONVEETEa t'HAwSbArOR 


j 13 1 ODD j 

I 11 

I 14 1 EVEN i 


j EV £N 


DS K and DSK-iam 

The format for a uevice of either usK or u3K-mia differs from the 
other devices la that a rileaame and’ riietype ror tne rile on disk 
be specified — i.e., 

1 FILEDSF I tiieid device filename tiietype <parms> <(optioas> 1 


filename fiietype are the CHS rue identixiers ror tne disk rile. 

The fiiemode of the disn file may be specitiea witn the DSK-mm 
form of the DEK device, «aere mm is the mode letter and aode 
Dumber desired. 
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Ihe Vdixct pdrametertcL JJd and dSK-uim ace djiCrd, LRECL, aad 
eiK5IZ, (liiert; are addit-iondi pax:dmeters ior duAd uisk files 
described later rri this sectioa.J 

Ihe metnoa by which these may be ueriued as describea under TAP, 
DSK files foL bPAtt p ro ces siiiAj 

Ihe sdiiie rules apply ter disK files for buAM processiny as apply 
to USK tiles fh yenerai. xiJ aaaftiua, KsYLEN, LlilCT, and 

CPTCi) may be specified, 

KEYLEM iiu specifies the size of tne record Key in bytes, 

XTENT an specffxes tiie auffiber ox records lu tae extent for the 

. file. A default, value ot bO is assuaied. 


LldCT lui speciiies the auffiber oi extra tracKs or uIocks tc be 
searched. ^ 

OP'ICD code specifies the uirect access processiay desired. Code 
liiay be cue of tae foilowiiiy: - 

A Actual ue vfce addressiiiy 
E Extenueu searcu 

f ieedbacK aauiessany - 

R Relative biccK aadressiay 


Resp onse s: 
xxxxxxxx yyy 

When FILEDEF is issued with ao paraifleteis, a ixst oi current file 
definitions is typed. xxxxxxxx is the . fiieid defined, and yyy is 
the device for’ waich it as defined. 

Exam pl es: 

a, iiiedef , 

ET04E001 DSK fiienaiue iiietype 

TEXT DSK . 

A list of ail cuffeat iiie definitions is typed. 

a. fiiedef ^ clear 

Ail file deffiiitiGus are clearea excepr any that may have been 
defined with the PExul ot^tiou, . . , 


c. tiledef text pun 
f^k file del init ton for 


iEl'T as uefined to tlie card punch. 
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d» t'lledel jU uSK aew fiit; 

A iiie uetiiiitiou is createa toi. r'XuUi’Uil on dxsK aith the C£SS 
file ideiitiiier NEW EILr. 

e, Eiieciet outlile dsK output, tost roctm id biicsxz J2u {perm 
A permuaent ueLinition tor oUXiiLi, rs set up. Tae trie is deiiaed 
to disK., where rt*s fiieaume uiiu • type are OdiPUT i'Eal, it is 
tixed-tiiocXeu, j 2G bytes per bruCK.. Tais deiinitron aoids until a 
ElLEdEF OUTFiLE CLEAR is rssueu, or tne user re-IPL's CMS. 


Er ro r Messages: 

E{0tJ J1) FILL u 1 : P ARi'i 1 IRVALln 

ihe first pardiaeter is something otner than au a one or 

twc-diyit number, or a DbNAiiE. 

E(OC002) FiLv,C2j SAD Ri'R CODE 

liie FiLEDEir oontiaauu got a uau retara coue troia its call to SVCfEEE 
or SVCfRi:,'!. Tuis is a system proDiem not correctable ny the user. 
Try the couimauu again. 

E(OCiOJ) FARaMETBRS MiSSiWC AFTEa OPERARo xxxxxxxx 
A parameter reguired by the FlLabEF comiuand has oeen left out cf 
the option list ny tne user. Retype tne command witn the prcper 
options. 

E{0j04) superfluous Or iRVAalD pARAHtlERS Atraa XXXXXXXX 

Cue or luore parameters arter xxxxxxxx rs supertiuous or invalid. 

Retype the ccmmaud with tue proper option list. 

E (000 JS) FiLCu'it BAD IRECL Or BEKSia VALUES 
One of the ioircwiag c'oimitious exists; 

Value exceeded the maximuai ailowabie size. 

LReCL or BLKSIE values contained nounumerics. 

E (000 )6) ILLEGAL XXXXX REiAOESi' 
xxxxx iS either OUMMi or CaEaR. 

ILLEGAL clear REQUEST is yeueratea when a CLEAR reyuest is made 
for a rile definition not created oy tae user. ILLEGAL DUMMI 
EEQUESf is generated wfea a DUMMl reyuest is made ror D0NAME or 
DSSh which has already teen uetinea oy FLLEDEF. • 

£(00007) FiLCC7: DS-i'jA£3E/-i’lPE MUST BE SPECIFIED 

Ihese items are reyuiteu when DSK is specified. Retype the 
EILEDEF ccmmauu witn the proper parameters. ; 

E(OUOOB) FliouB; PaRMI ilUSi BE DbRAdE 

Ihe user has iert out an eDRAilE or DSRN as his rirst parameter. 
Retype the FILEnEF command with tne proper parameters. 
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^£CGJCU'3} fiLU03: BAD OP^cD PAkAWEi'BA 
\ Xhe usee was specieled an uasuppoeted 
code must be eitiier B, A, ue A. 


option code. 


The opticn 





O 
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ijlij.'APE - New t'dLuaieteis ot biocKin«j factor 
' and j:,of 


P urpos e: . 

WBTAPc; copies riies, fixea aud yatidbie j.euytfi, troiB disk to tape* 
It the liletype IS *LlaXiNG*, Assembler and compiler carriage ~ 
cciitrcl coaes are translatea to aaciirue codes. 


Fo r m a t: ■ 

faBlAPE fname ftype <i:fflode> <biockiuy factor-? <EOF> 

P datauit 1,0 default ‘NO EOF* 

fname ttype rmoae Specifies the file to be copied 


Csa^g: . 

WHTAPf copies fries tiois a specified. iogged-iQ disk to TAP2, 
decords can re fired length or variable length'. The tape is not 
rewound when tne commana* comp'retes. Blocking of records cai^ be 
specified oy tue user. 


dfcTAPS handies any file ox tae rormat previously described. In 
the case of a ilSTlNG file created either by the ASSEJaBLi^ Pl/Ig 
or FOaTBAN couuQdndSs it translates the rirst byte of each record^, 
which is the carriage contror code, into machine coae for the 
printer. 


Eotes ; 

a, yRTAPb roriiiat of writing files to tape is acceptable to the 
ccffitnand •lAPhlNT* if a olockiny Lactor of ten is speciried, 

b. Use the facilities or the lAPb command to position the tape 
past any existing tires, I'o mark an end of file for the 
comiaand M'APaiNl' , t wo end of rire marks must be written, 

must oe attacued uy tae opecaxot. •TAP2*, 
Siioula ue Sj-ecified when the operator is 
t.ue tape, 

d. Tape tiles written wita ykTaPB are not suitable for re-reading 
with TAPE Load, 

e, ilaximuiii biccK size accepted = 32, 7db oytes 


Ce Under CP, the tape 
addressed at 181, 
ceguested to attach 
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Ke££onses: - 

fJcne.' ■ 

Ex,^£ie: ' , 

ttri'fAt't PftuG SCttiPT a 1 1yU EOF , 

Xbe file PEOo Ec.itiPT has vaiiaaie iaugtn records and «hen cofied 
to tape, the records are grouped ru oiocxs of 1QU and end-of“file 
is written. 


Error M essag es; 

£(CuCd2) PAHAi'iETEii EkHUH 
Invalid parauieter list was entered 

E(ddOOJ) iiLOCK SiZn TOO LARGE 

fiiocK siiie exceeds maxiaium 32, 766 oyces 

E (0003 4) FILL HCT POUND • • ' . 

file specified not found 

£ (0000,5) fcAHOiv Hlading FILL 

Error occurred reaaiiig file rroui arsK 

E(xiXXX) TAPE LrutOH 

A tape error occurred wiiich could not de recovered. TLe error code 
i£ unpcedictaijie. 





PAGE 25 


CCMPA^t - New ci-tica 
Fotffldc: 


CU:iPAPL 

(N-JSiiv) = 


lileiiaaie I £ii«t - £ iieiaoue 1 iiieadiuez £i.ietype2 
tiitffiode^ (NUlilig) 

Lio nd£ check last exjht dytes ox xecoxde 


Acid iti o tidl Hesjjcnsea; 

PliiST Flah NCI POO ho 
SECChi) flLh NOT f’OUhU 

FIHST ANu dECUhO i iA.E (Sj ahE TxlE EaME FILE 

r 


Sl'cot Kegsaaes - ■ , 

C^gpilgjiBjj-d'acx eat Exrox de soage a) : . ' - ' 

E(OuOOI). Parduietex exTox 

B(0voU2) EiXiit diici ^ecouu £ilG(s} are the same tile* 
H(OCOOJ) At least one xecoxd aitfers. 

S(0Uu04) EArAE EdaOR ■ 
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OffLX.Mii - iievif pdtdiiititei: ot * * ana * ■i' tiu 


Format: 

C f FLIi'Jii*' 


comiftdua riieiidme tixetype <fiieaiode> 

. fia 

AsttriSKs; Vdiiu only commaad =' EiiAiJ 



specifies tiiat tixeiidflie, xxietype 
touiid xn Ot F LlLiE REiiiJ Control cacd 
Cdru dtream. 


<ilid x ixeffl oa e axe 
s xti tiie in pa t 


* « 


* * rm 


specixies that tiie xxiename, 
in oifLxNii rfiAi) control caras 
stxedia, mode aefduitii to 'p« 


ixletype are xound 
in the xuput card 
disK, 


speciiies tuat tne ixieuamef 
in UFxLiNii nxAiJ co’ntxoi cards 
stream; inode accepted xs the 
tne .ccicmand lxne*' 


xxletype are round 
xn tne xaput card 

one xjpecxtxed in 
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V5t,r , ■ , 

ir UC p OliO: 

VSiiT aiiows tiit; usei: to ccnttoi aiitoueat aspects ot has 

enviEonmeiit at has conscle. dLIP coiitcois the 

character desi 9 iiated to liutiiy the user or every two CPU seconds 

cf execatioii tame; VSEI CilAKdEF coatrois tue defanataons 

for iotjacai syrnhoiSf such as iaae aeaete# character 

delete, fcacKspace, ana tao Characters, and the hexadecimal 

represeatatioh cl defined characters^ tfSEl idPEx controls 

the order of search for coaiiuanus; Vhuf LDSaULS controls 

the nuiBber oa pajes of core used roc loader tahies; 

VSET LitlENiJ coatrois the uefaiiataou for the logacai line-end 
character; VSET controls the xenyth of the error ^ 

and ready messages typed uy CMS; VSEI' xiEdTlPE controls the 
ccior of the CnS error messages; and VSET hELPAe controls 
the celeasrng of pages cr core upon commaaa completion. 

f 

format: ♦ 


J VSET 1 tuuctaen <operanas>| 


function may be one oi tne toiaowang: 

SLIP 
C HAttDnf 
IdPEX 
nDKTBLS 
LINEND 

EDidSb ■ 

. , ■KEDTYPE 

RELPAG . . , 

operands are described under ‘‘usage*' ior eacn particular 
function. 

Osdg,e; 

VSET has aiuitiple uses' depeaaany upon the function specifaed. 
Each is described below. 

VSET^BLIP 


! VSET BLIP <chdr <ccuut» j 
I (UFF) 1 i 


char as the character (s) to be typed. The default as a sequence 
of nonprinting characters — uppercase shaft, lowercase. 
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/~N^tOFf) sets bLj-P to uctftiiij, iio ttiere is uo luaicdtiou o£ CPU 
oxecutioii time Deiug asou. 

couat IS a uumter tioiu 1-b luaicatiay tae number ox characters in 
Guar. i’te default is 1 character. 

Ihe chdractex(s) specified axe rypea every two seconds of CPU 
execution time tc give the user a printed recording or the 
exe-cutioa time of uis program. ir the ueiauit character is used, 
the typing element shitts to uppercase, then lowercase, to 
indicate the CPU execution time. Nothing prints. The entire 
execution time ladicaticu ol iiaiP can be turned orr with the (OFF) 
operand., A user may specify noucharacter ULiP indicators by 
specifying them in hexadecimai in an Assembiy Language Program. 

VSET CHAaDBf ■ 


1 VUE I 1 CtiAhULf logsym cchai> | 

j I transtype vchar <hexcyde>> | 


iogsym speciries Cue iogicai symnoi for which a character is 
beiny defined, i’ae valid loyicai symbols and their 
meanings are described below. . - • 

iogicai aacxspace syuiLoi in EDIT, ine default symbol 

IS % 9 ■ ■ , • 

iog icai cuarac tei-deiete symbol. The aetault syiabcl is 

d . 

logical iine-aeiete symbol. Tae deiauit symbol is 0 , 
iogicai tan symbol in EbiT, iae default symbol is 

transtype speciiies tae type of traasiation being deliaed for the 
character representeu. Ihe valid translation types and 
their meanings are aescribed below. 

IN tetmiaai input translation to nexadecimai 
OU termiaai output translation to hexauecimai 
Id terminal input ana output translation to hexadeciaai 

chat specifies eitaer the character to be defined as a logical 

symbol, or the character tor whica translation to 
hexadecimal is to ne made. If a caacacter is not 
speciiied, there is no character for that logical symbol, 
or dll translations for that translation type ace 

cancelled. 

hexcode specifies the speciiic uexadecimai lepresentation to- 
waicn caar is to be translated. , 

''^here are two general ways in which CHAhbEF can oe used - to 
define iogicai symbols, and to uefiue character translations to 
bexadecimai. 
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For lojiCdi syiEDcis, ciiar Decoines tue symbol roc the logical 
tunctcoa specitaeti. Ir uo cxiar is specifietl, tnere is no syisboi 
tot that logical runcticu. The aellnitions tor backspace and Tab 
are efrective only in liUIT and cEDXT. The aeiinitions for 
Chaiact'er ana line are eiiective lor Cdb and all its commands 
(including buiT, CEDIT, and bhbdG) , but not tor CP, by redefining 
'^the deiauit logical symtol ciiaracters (i.e. k tor bacKspace, d for 
character-delete, (t tor line delete, # tor tab) , these characters 
may be typea as n’ocaal input characters. 

For Character trauslat1cns, char becomes the cnaracter that i£ to 
te translated to tne hexadecimai representation specified. The 
traaslaticn occurs at the time specilied ny the transiatipn symbol 
(i.e., on terminal input by 111, on terminal output by OU, or on 
both terminal input and output by 10), In tais way, cnaracters not 
represented on a specific keyooara may be entered by specifying 
the Char defined to the nexadeciuidi representation or the misring 
character, lor example, a’teriainai not having a <. sign, migat use 
the ( to eater a < by specifying Vbnl CriabUEF Id ( 4C, It no char 
is specilied with a translation type (i.e., Ih, OU, or 10), ail 
translations or tnat type are cancelled. 

The Characters aetined cy Vbbi' CnAkbEF leiuain in elfect uutil (1) 
another VSbT CHAhOKF eitaer changes or cancels it, (2) CMS is 
relPL’ed, or (3) the user logs out of CP, 

VSET I flPEk , ; 


I VSET 1 IMPEX ON 1 

1 1 oFe 1 


ON specilies that when a command is entered from the terminal, 
the search is irrst lor a rile .-.'itn a fiietype of EXEC, then 
for a iiietype or ilOUUnE. This is tae default, 

OFF specilies that the search ror liletype EXEC is to be 
bypassed. 

The order ol search tor commanas specified at the terminal may be 
altered by the user with the . VSET iMPEX command. Normally, when a 
ccnimaud is typed, there is an implied search first for a fiietype 
cf EXEC. For example, ii SAMPLE is typed at the terminal, CMS 
first searches tor a trie SAMPLE EXEC, if tnis is lound, it is 
executed as if EXEC SAMPni, had been typed. If this tile is net 
found, there is a checx ol user, then system, aarreviatioas -'and, 
if SAMPLE is an abbreviation, it is expanded and a^ search is made 
tor the extended fname EXEC, II extfname EXEC is found, it is 
executed as it EXEC extluame haa neea typed. 


• • J’AGE 30 

Oif tiie searcii iiof an iui^iiea liXEC rxietype is not succesiJfui, the 
search is then made iot oAtiFLE MuuOLE. it rouua, it is executed 
as if LOADdUL) EAdi-LE then STAhi were typed, ii it is not round and 
SAMPLE is a user 6r system abureviatrou, a search is made tor 
extruama MODULE. Ir this is founa, it is executed; if it is not 
found tiie ?CMS message is typea indicatiuy an invalid command, 

i^ith VSEi’ IMPEX OFF, the first senes or searcues for the £X£C 
fil4"are bypassed -- aau the searcn is only made tor filetype 
MODULE. In this mode, EXEC rxies may be executed only by 
explicitly typing EXEC fuame. 

VS ET L U RIB LS 


i VSET 1 LDhTBLS <nu> J 


on is the nuiaber of pages of core tue user woula iiXe to have 
set aside for loader tauies. If omitted, the number of pages 
of core currently set aside' for loader tables is typed. 

The user may examine or chaiije the number of pages of core used 
for loader tables with VSET LDETBiS. 

(^Mormaiiy, a virtual macaine of 25qK iidS two (2j pages of leader 
tables a larger virtual machiae nas three (3). This number may be 
changed with VSET LDuTtLS min provided that (1) nnii is a decimal 
number less than 12d, ana (2j the user has enouyh core available 
to allow nnn pages to be used lor loader tables. If both or these 
conditions are met, nun pages are set aside for loaaer tables. 

If a VSET LDETiiLS reguest' fails oecause there rs not enough cere, 
a smaller number or pages should oe ceguested. Ir the reguest 
fails because cere is in use, the user may re--lPE CMS, issue LOGIN 
(NODISK, then request the number of pages again. • - 

A user may riud out the numoer or pages of loader tables in his 
virtual machine at any time by VSET LDhTbLS with no operand, 

E esponse s; 

NUMBEE Of PAGES fCh L0ALE« TABiES: nan 

This response occurs when VSET EDaTBLS nas been specified with no 
eperauds. nan is the current number ox igader taoie pages the 
user has. ■ 
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VSET_i4iiMi^ 


I VSEI- I LINEMD <chac> ■ 1 


Char apecities tne chairactec -tuat is to become the loyical 
Itne-eab symbol, Tne aebauit symbol is #, It no symbol is 
specitiea, uo chardcter is deliued as tae iogicai line-end, 
and the only feay to end a line is with carnage return* 

the iogicai iine-end chaiactei permits a number ot logical input 
lines (each separated by the iiue-end s/mooi) to be typed on a 
single physical input line.. The pnysicai input line is terminated 
by a carriage return. Logical input lines are terminated by the 
line-end charactei or by the carnage return. bach call to read a 
line from the temnai leturns the logical input line. Subsequent 
calls to read a line rtoiu tne terminal return the next logical 
input line. 

Ihe line-end symbol cau re used to input muitipie iogicai lines 
whenever a physical line is input iioin tiie typewriter, -whether to 
CHS or to a piogratTi. in additioxi, iogicai lines can be input and 
stacked by use ot attention to CttS (double atteution it tcom CftS 
and running under CP). see Te'rmiiidi Usaye“'’Attentioii Interrupt*’. 

it no VSLT LIhLhb nas been issued, the A'is the iogicai iine-end 
symbol. The pound sign («) is also tne logical tab symbol, but 
the line-end syniuci takes pieceaence over the tab symbol. 

If VSbl LlNbiNih has nc operaud, thoLO is no iogicai iine-end 
syoiboi; logical lines, must be tei'miii.ited as physical lines with 
the cairidge letuin. • , \ 

VSET Lli'iEND uoes not redebine tne iogicai iiue-eud symbol tor CP. 

\5£ 1 ri ii fiS G ■’ . 


I VSET j huiaSG-UXi i 
i i uPF J 


CN speciiies tnat - Cdb is to typo staadaru error aud ready 
messages (eg. h; T=aii,na/uu.nn hn.aiu.ss) ' ■ 

OFF specities that abbreviated erroi and ready messages (eg. H;) 
are to be typed. • 


Abbreviated ecicr ana ready messages (i.e., ii (nnnnnj ; and h;) may 
be requested with VSFT ndiiiSG urF. besides the shorter message 
(which eliEinates the printout or CdG and Cdb -«■ CP execution time 


and the clock time), 


there is one carnage return rather than the 


usual two. 
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1SET_KEJJXY VK 



1 VSST i aEDXYPi UFF i 
I I Oti~ I 


QFf syeciliea that all Cli3 erroL' aeijsa<jes are to he tyjjed in 
orack. This is the deraurt vaiu-e. 

CN st-ociiies that error: messayes are to Oe typea in red. 

Provided a terminai is eyuipped wich the red ribbon control 
feature (HPQ 486d019) ana a olacK-rea ribbon, hEbTYPE Oh aiiotes a 
user to have CMS error messayes typed ia red, A KE command (to 
truncate terminai output lines) has no eliect on lines typed in 
red. 

If a user speciries REL'iYPb UN, and the teraiinai is not equipped 
as described above, extraneous characters may be typed.- 

ISEl_jlEL£AG , ' ; 




Sii specifies that after certaiii commands have executed, core is 
to be reieased and leroed, inis is che default. 

OFr specifies tnat the contents or core are to remain alter the 
completion of certain commands. 

alien CMS is runniuy iii a virtual machine, payes of core are 

released and zeroed after the loiioaing commands complete 

execution: aSS EnbLE, CEbii, CUddinE', COMPARE, EDIT, FORTBAN, 

KACLIB, MAPPRT, PLI, SORT, SPhi'T, TAPE, TXTLlB, and UPDATE. This 
is the normal mode of operation - .tuai obtained by default or «hen 
^SET SELPAG UN is specilied. 

Hcaevet, it a user wisnes ro examine core after any of these 

commands has linisned - e.y., tor aebuyyiay or analyziny a profclem 

“ it IS desirable to inhibit tais teitiasiay feature. This is done 
with VSET RELPAG OFF. The commands aifectea are given in the above 
paragraph. 

Examples: 

a, vset blip i 

This causes tne yuestion marx (?) to print after every .^wo seccuds 
of CPU execution time, giving tne user a record of CPU time 
^,'^xecution. 









b; Vot;t cnardei. c 1 

lie character'-aelete detiued to the exciamation pciat 

(!), i'he a) Sj'uibci can ae used as noraiai input. 

c. vset cnaidet j 

The lino-aeiete symaoi ug ioa-jec exists. , The 0 can be used as a 
noiiaal xaput character. 

d. vset cnarder in ( 4C 

The ( IS' transiatad tc a hex 4C (the < symbol) whenever it is 
inputted. Tnis enduies a < to be inputted trom a termiaal that 
does not have a < symbol. 

e. vset charaet in 

Aii previously deiiued input character trausiatious are cancelled, 
t, vset impex otf ■ 

The nocmal implied searcn tor a tiietype of KXiJC is bypassed. To 
execute an Elbe tiie, EXEC liiename must be entered. 

f ■ 

q, vset Idrtbis ' 

NOWbh'K Gl PAGES t'Od itOADEg TABLES; 2 
The current 'number of payes of core set aside for loader tables is 

2 . ■ ■ . ., , ; ' , 

fa, vset Idrtbrs 4 

There are now 4 payes of core set aside tor loader tables, 

i, vset linend ! 

The irne-eud symbcl is set to tne exclamation marx (J). 

j, vset rdyiasy off 

a; 

erase no file 
E (00002) 

CMS ready and error messayes are abbreviated as saowu. 

K, vset tdymsy on 

g; r=000/0,01 ii.30.0o 

erase no file 

E (00002) ; T=0.00/0,0 1 13.30.14 Standard CMS error and ready 

messayes are typed to tie termruai. 
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^^:^Er ro r M es sages; 

£ (000 J 1) VoTJ J 1 : EAD CriAEOEF AriGUrlENE 

Either ao or iuvdira OEeranais were specitied with VSET CHASCEf. 
Beissae the ccmmand. 

E(0C002) VST002; bAD VSET EUdCTiON 

Eitnec no or an invalra tunction was specified with VSET. 

£(00003) VSTuOJj bAD. leChi'biib aBGUdbdi' ■ 

Either Qo or an invalid operand was specified witn VSEI LDhTELS. 
If an operand is specified, it must he a decimai naifioec less than 

£(U0004) VSIC04: CANNOi .MOhiEf LUAbEK TAbhES 

Ihe number of pages regaested witu VSET hhiVi’bhS is greater than 

the iiuffiber of pages avaiiaoie, or the core is already in use,/ 

Either (1) reguest a sttaiier number of pages, or (2) re-ipi CK3, 
issue LOGIN (WODiSK, then try VSE'f LDiiTbLE agara. 

£(00005) VSTOQb; bAD arfi'iSG AuGUfiEi'iT 

lie only valid operands ror VEEi bDfWJo are ON ana OfE, one of 

Hhien must be specified. The ready and error message iengtns are 
not affected. beassue tne commana. 

£(00006) VST006; bAD lEPEX AiiGUdENr 

/^he only valid operands lor VE E’T idPEi ar e ON and OE’P, one cf 
^hich must be specif red. Reissue tne commaiid. 

£{0r0j7) VS1007; BAD HEhiYPE i^RGUdENx 

Ihe only valid operands ror VEri hsDTYPii are On and OFF, one of 
whicn must be specified. beissue tiie coauuand. 

E(OOOOB) VETOUd; BAD HELPkG AiiGUriEET 

Ihe only valid operands for VEEI bSrPAG are On and OFF, one of 

which must be specified. Reissue tne commaud. 
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KE 


i’he Ki, commana coutfoiii the iehgtn or the line beina 
typed at the teiminai. ^ 


ftcMAT; 


J KE I <nn> } 

1 --J_._™i ■ ^ 

Ke is activated troa the cp-67 eiiviroisaeat (entered frca 
(-Mb oy iiitting the atta Key) ay typing in KE nn or KE. lOlNI gives 
ccutroi to COivoi (see C&S ^uA Gy2d-j59l) waiCft determines whether 
cc not an operand was entered, it not^ a detault value of 72 is 
assumed. Tne cclumn limit is set to the speciliea value, the KS 
tiag nrt is set, tne ATTN butter is released, auu control is 
tetutned to iOlNT. 


EXAMPLE 


S e- ■ X ^ ^ 

Ixie line length is set to the uetauit value ot 72 characterse 
hi, ^ Ke 3U ' . ’ ' . 

the line length xs set to/do ciiasacters* ■ ' 
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I 





KILL; suppresses ail tyjJiflij to tae tenBiiiai. 

HESUI1K; returns termrual typing to the status prior to the 

kill cciumand, 

N ew ALIgB Opt ion 

Gpt ioa s: 

TYPE Will type altered riles 

bJOUP directory rs not updated 


Usag e; - 

The TYPE option Will type the name and/or type and/or mode of the 
altered tile dependiag cu uhrch fields contain an asterisk in the 
cid filename^ old fiietype, or old fileuiode. 


New EEAS E upti og ‘ ■ 

TYPE in parameter list after iiletype or mode will type the files 
that are being erasea. 


N ew Page Rele ase Fac il i ty 


ASSErfBLE 
CEDIl 
CCKBINE 
CC MPAnE 


EDIT 
Fun InA N 
EAtLlB 
W A11EI 
PL/1 


BO KT 
SPLIT 
XA PE 
TXTLIB 
UPDATE 


These routines now inciude the user page release function 
described in the roilouiug paragraph. 


After successiul completion and prior to returning to the user or 
caller the current routine references NUCON and turns the page 
release flag on. When the program returns to INl'T, .^this rlag is 
chec/ced and if it is on, TNIT issues a diagnose X‘10* to CP to 
release the user pages iroia 12u00 Hex up to the value of LOWEXT. 


If the user wisnes to prevent the 


release or ^ages^ he must issue 







cas 


COfflJnduU VS£X faiiiP&G Oi’i’ 


(see VSET) . 
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6 . - 

To make the iilenames ct Cd3 soutce toutines laoie meaningful to 
the system progtammet respousinie Lot maintatuing CMS, a naming 
convention has been estabiasned. A routine’s function and 
relationship to other routines wrii couseguently be identified by 
prefixes and suffixes, Some naming conventions: 

, device aependent loutiues prefixed by a code aeuoting 
tue physciai aevice type; e.g., DISK, CONsoie, etc. 

, device interrupt haudiers\suttixed by ”1^1": (^^*3NINT) 

. software iuturrupts preiixea by "INT”: ( ib iSVC) 

. simulators of uS functions prefixed by '‘SG"; (SOQSAi-i) 

, miscellaneous routines oi similar functions prefixeu 
by the same code: (iaridSlS, FKEiXTND) 

. device input/output executors suflixea by “lO”: (TAPEXO) 

The followiny chart will show: 

1, the filename of the source SiSih deck 

2, the rnternai entry poiatts) or STAKT card label 
if dissimilar from the tiiename 

3, how the routine is used; ' 

N - nucleus resident 

NI - nucleus resident during the IPL procedure oaiy -■ 
then no longer neeued 
NS “ nucleus resiaent, sharabie code 
D “ disk resident moauie 

DC - component oi a disk resident moduie 
T ~ transient moauie 

4, relaticnship between versions 3,0 and 3.1 with respect to 

the individuai routine; 

S - same, routine is uncnaiiged 

U - updated, the update decx that was used to generate 
the current version or the routine will be 
. ■■ .' supplied. - 

:UN updated ana reuameu. fne newiy named update deck 
will be supplied. Note; the version 3.0 source and 
tiie version 3.1 source - prior to applying the 
update - are identicai. 

R - repiacement, complete substitute for the menticned 
version 3 source routines 

KN - rename, the riieiiame of the version 3.0 source deck 







V' 


was cnanged. 
ij - new ■ 


b, a brief coiiiaent 

about eacxi function 


r lucernal 

iielation 


External Eutr^ 

¥is a Vis 


Filenaine Fcrnt Usaye 

Vei 3. 0 

Functions 



$ 


T 

U 

execution initiator 

ABBHEV 


N 

’ s 

abDreviation processor . 

ACILKP 


NS 

u 

determine active files 

&DTLKP 


NS 

u 

aetermine available disks 

ALTER 


T 

u 

change iile identification 

ASHDIHT 


DC 

E-AStlDIRT 

ASSEUBbER auxiliary directory 

ASSfaBLE 


D 

R~ AS SENB LE,A SHREAL 
ASMAU1,aSMA02 
ASMA03 , ASMAFIND 

ASSEMBLER interface 

BATBOMB 


N 

s ■ ‘ 

batch monitor component 

BATCH 

' 

N 

u ' 

natch monitor ccmponent 

BAIDECC 

- 

N 

s 

batch monitor component 

BATJCB 


Li 


natcii monitor compcnent 

EATLIST 

- 

N 

s . 

natcn monitor component 

^.ATPHES 


N. 

s • 

batch monitor component 

^ \tsctl 


N 

s 

batcn monitor ccmponent 

CARDIO 

CAiiDHDPH . 

N 

3 

reader/punch executor 

CEBIT 

- 

D 

u 

editor for large files 

CLOSXO 


N 

s 

close executor for Unit Record 
Eguipment 

GMSCAfiE 


T 

N 

auxiliary command module 

cascoKf 

• . CPf U.I^'Cli ■■ 

T 

u 

vrrtual CP console furiction 
executor 

CaSFOSM 

FORMAT 

D 

u 

drsK. torma ttor 

CHSIPL 

IPL 

T 

s 

CbS.iPL invoker 

CHSTIME 

- 

NS 

R-CaSTItiE 

vrrtual time accounter 

GNVTFIV 

C?TF¥- 

D 

RS~CVTFV 

convert rixed/varrabie 

CNVT26 

“ 

D 

i> 

convert 026/029 

CGMBIME 

- 

D 

H-CUbblNE 

file manipuiatcr 

eCMPAHE 

- 

D 

U 

irie matchmaker 

CONATTN 

ATTH 

NS 

UN-aTTN 

attention handler 

CONINT 

CQH^l 

NS 

UN-CONINT 

console interrupts 

CONBEAD 

WAITHB 

NS 

UN-NAITRD 

console input 

CCRWAIT 

■ 

NS 

U ' 

console wart 

CONWRITE 

TIBE 

NS 

UN-TfPLlN 

console write 

CIBDUMP 

- 

N 

N 

uebug dump executor 

DEBUG 


N . 

Q 

problem determination aide 

DISK 


D 

U 

disk utility 

DISKINT 

- 

N 

UN-DIOSECT 

disk interrupts 

DISKIO 

£DfK/yRTK 

NS 

UN-DIO 

disk I/O executor 

'^yapRST 

DUilPHEST 

D 

3 

dump/restore utility 

-tJMPD 

— 

D 

5 

dump disk ucility 




UUMPi? 


u 

3 ' 

aufflp liie utility 

ECHO 


D. 

B . 

termiual tester 

EDIT 


D 

D 

eaitor 

EDiTD'JAL 

■ - 

NS 

u . . 

iiie erdciicator 

EfiASE 

- 

N3 

u 

liie eradiedtor 

ElEC 


NS 

■ 0. ■ 

exec Bootstrap 

EXECTUK 


0 

u 

exec worX module 

FILKDEf 

- 

r 

iX-FILi,DEF 

Ueline rile routine 

FINIS 

- 

NS 

U 

liie aeactivator 

EOaDiST 

- 

DC 

a-FORT dirt 

FORTRAN auxiliary directory 

FORTHAN 


D 

R-FOKTRaN, 

FUuTiO, 

FORTRAN ijiteriace 

E H EtSY 3 

FHEE/FRi:]! 

N S 

uN-C.&SFK 

system free storage 

FHEEXi’N 


N 

UN-CM3 EaTND 

system tree storage 

FSTLKP 

- 

N S 

u 

file looxup 

FONCTAD 

- 

NS 

r-FUNcTAB 

internal function table 

GENDIHX 

LUADdOD/ 

T 

— S - 

auxiliary direct generator 

G E N i1 Q D 

^ uENdOD 

NS 


module manipulator 

GIOBaL 

■ - 

r 

tvrGi-iOiiALi 

linrary governess 

ENDINT 


'T.''>-'.' 


handle I/O interrupts 

HNDSVC 

'■ - . 

I-.-. ... 

. 5' 

nandie SVC interrupts 

lADT 


NS. ' 

' u ■ 

init Active Disk labies 

I NIT 


N 

; U 

initializer 

INITIEL 

TRAi^SAH, 

.... .lEEMSK; ' 

N1 

R-i^AST^ 

....iE-LD-lSK 

reads cas from disk 

IN IT3b7 

iiARF67 

N i 

£C-*iiAEE67 

Bare CPU initial processor 

INITSUB 

- 

Ni 

U 

suB-initializer 

INiTSy3 

-3 1SGEN 

N1 

aU-'S 1SG£M . - . 

initializes S-disk 

INTEXT 

EXTIWT 

NS 

Ui^'-CilSEXTii- 

external interrupt 

INTIO 

lOINf 

NS 

UN -CMSXUIT 

I/O interrupt 

INTMACH 

HCaiRT 

NS 

N 

machine interupt 

INTPaOG 

PfiGIRf 

NS 

M-CHSPRGIT 

program interrupt 

INTSECT 

- 

N 

N 

interrupts work area 

INTSVC 

SVCiNT 

NS 

R-CilSSVC IT 

SVC interrupt 

lOFHTAB 


N 

R 

uisk tables 

ICEHS 

* 

N 

■ N ■ 

I/O error processor 

lONUTAB 

■ 

D 


I/O error tables 

IXCBLTP 


DC 

'S' 

fortran library 

Excess 

- 

DC 

u 

Fortran library 

IXCDEF 

- 

DC 

s 

Fortran library 

IXCDEFTB 

- 

DC ■ 

‘ ' s 

Fortran library . 

IXCDSD 


DC 

s ^ 

. Fortran library 

iXCEHES 

- 

DC 

^s 

Fortran library 

IXCGETP 


DC 

■ ^ s, . 

Fortran library 

IXGRENM 

- 

DC 

s 

Fortran library 

iXCHERD 


DC 


fortran library 

IXCTAP 


DC 

■' S 

Fortran library. 

IXECM3 

- 

DC 

ii- iXECMS' 

PL/I library 

IXECLGK 


DC 

R-“IX£CLOK 

PL/I library 

iXEFILE 

- 

DC 

R- iX £F IL £ 

PL/i library / . 

IDR 

. - 

NS 

U 

relocatable loader 

LDHIO 

- 

N 

R-ID RIG 

ibaaer I/O executor 

LDHLI3E 


S 

R— £i £ IS £ 

loader library processor 






u 

d*" LmU Li^lidS 

A, • V 
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iocidcr iiuDroutiae 

iuaSYii 

OElS^fl 

u 

Kr J if H 

loadei isymoois ^ J 

LiSTF 


T 


list Hies 

LOAD 

~ : 

N 

u 

iodd iuitidtoi: : 

LOG 


N 

u 

nidintdjLn disk direct 

LCGIM 


T 

-U ■ 

ioyiii a disjt 

MACLIB 


D 

y 

aidero iicrary 

EAtPKf 


D 

u 

iiucieUS map 

MODMA? 

- 

T 

/ 5 

module map 

RUCON 

- 

n 

fi-NUCUNTS 

uucleus constants 

JiODVEXT 

, - 


u 

i/0 device taoles 

RUSECJ! 

- 

N 

' u , 

aucieus worx section 

offline 

. . - 

tTI 

■ i.- 

ii-OIFLi.dE 

file utility 

CSTAPE 

- 

D 

s 

tape-riie utility : 

OVSFfilDE 

- 

D 

U 

override executor ^ 

OVEHSaii 

- 

DC 

uu-Jkso^m 

overriae executor 

PLI 


D 

B-PL/I 

PL/I interface 

ELIDIttT 

- 

DC 

U 

PL/I auxiliary directory 

POINT 


US 

s 

sys iiie manipulator 

PKiNTF 

■ , 

T 

^ . 

print files 

PfilNTIO 

PKINIH 

NS 

OM-PSiivrE 

printer executor 

QQIKK 

- 

NS 

s ■ ^ ■ 

track manager - 

SDBUF 

- 

ws 

0 

basic read executor 

EEADFST 

- 

DC 

u 

login module 

HLADSFD 


DC 

y ^ 

login module 

/^'\ELEASE 


T 

u 

release user disk 

-ELUF-D 

- 

DC 

u 

login module 

SCAN 

”* 

N 

u 

decipher input lines 

3CSF Qd 

- 

DC 


script module 

SCSLNK 


DC 

■ , s 

script module 

SC3PHT 

SCkIPT - 

D 

s ■ 

script processor 

SOABEND 

- 

N 


a-ABSTD 'S'siffl of OS ABEND 

SGBDAfl 

- 

NS 

N' 

’^‘sira of BEAM 

SOBS All 

- 

NS 

iiD Ud 

^siffi of BSAM 

SOCNTHL 

■■ ; -■ 

NS 

R-UtyT.CHECK 

*slm of NGTE/POINT/CBECK 

SOEOa 

- 

NS 

u 

* Sira of end-o£-block 

SOLINKS 

• - 

NS 

UM-LlUKkCE 

^sira of co,utrol transfers 

SCMAIN 


NS 

Ki^-‘:iTOt(AGK 

*sim of SVC 4,5^10 

SOOPCL 


NS 

E-OyEU 

’s^sim of SVC 20,22,23 

SOGSAM 

- 

NS 

R-GET 

^'sira of GET,PUT 

soar 


D 

U 

sort data within files 

SOETEEB 


DC 


sort uioaule 

SCHTSHCB 

- 

DC 

s ^ 

sort module , i 

SGSVCNU 


NS 

u 

=«=sim of raise SVC in nucleus 

SOSVGTE 


T 

ii-AVCCAAE ■ 

♦ siiu of raise SVC in transient 

SOSVCT2 

- 

T 

d-SVCCARE 

*sira of raise SVC in transient (cor. 

SPLIT 

- 

D 

u 

file utility 

STAET 

- 

N 


commence execution 

SIATDSK 

STAi: 

T 

u 

disk statistician ’ \ 

STATE 

. » 

NS 

u 

ilie lookup 

A“e 

“ 

c T 

u 

synonym processor , ; 


D 

u 

tape utility 

TAPEIO 


T 

s 

tape I/O executor 

TAFfilNT 


D 

■ ■ S' 

listing tape utility ; 
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IPCOPY 

THAP 

IBKLKF 

IXTLia 

UPCATE 

OPDISK 

USE 

WAIT 

8BBUF 

WBTAPE 


0 s 

N S 

S 3 

D ■ U 
D U 

NS U 

N U 

NS S 

NS . ,U 

D U 


copy tdpes 
interrupt trap 
tracK managemeQt 
library processor 
lile utility 
disk management 
load initiator 
I/O wait 

basic iffite executor 
tape write utility 


Si® o£** Bieans •"CMS siiauiation or tiie US function 


® e 


tf 



Improved subroatiae iiiikcijo. 

Some routines in the Ci-o7 nucleus nre called tor processing 
and exit later witn no •interveuihg calls to other modules, 
Ihese routines coula tiius use a common save area and linkage 
coula thus ce reduced to a simple hALh instead or the 
standard SVC’ call', Ine common- save .area used is named 
BALRSAVh and is located in module ISA in page zeio. The CALL 
macro nas been updated to select the correct linkage 
according to the called coutiue. The roilowing routines have 
been moditied to use the nnLh iinkage; 

CHKCUACT 

CP3TACK . \ 

hINbEC, blNHEX, DATETlhii, DEChli'i 
FeCOiiVf ilEkiilft 

DISACT ; 

f REE, FHJiT , FRti'R 
iOISTVDE, iOlSiVCU 
PAGUhLCK , 

QUEViO, UUEHIC, CHFREE 
HUhilSCh, VUiNlISCN 
URTRAKS 


Reference page algoritnuio 

The algorithm in PaGTraNS to select a page tor a user has 
beau moditied. Previously, the loop searched for an 
available page or a page belonging to a user not in a 
dispatchanle gueue. The modiliea loop searches tor a page 
that has not been reterenced* neterenced pages found in the 
loop have the reference nrt turned otf. It a non-referenced 
page caxinot be found, tuen tne scan continues to find the 
first non-referenced page. The reference nit will have been 
reset during the first scan, if a changed page is selected it 
must first he written out to auxiiliary storage >before the 
ceguested page can be read in. 


Improved DISPATCti 

The DISPATCH module naS neen completely re-written to give a 
cleaner interface irom other laodules, to improve ‘real* timer 
maintenance using a binary ciocx (HlRCLOCK) and to use fiiiite 
gueues for scheduling and dispatching users based upon 
priorities aagustea by user behaviour to conform to system 
restraints. 

Several new entry points have been defined in D.ISPATCH so 
that the dispatcher can determine whether-or-not a us€r*s 
status has changed, based upon tne entry and not upon 
detailed anaiysis. Certain entry conditions merely account 
. for user time and then contine to run the interrupted user. 
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yjL'ovideU hio ^adiitu«t iids iiot oeen exceeaed, UtheL' entry 
coaditroas dccount lor user time and, tnus, search £oc 
another user to run, haowra^ tuat tiie runniny user is uo« not 
cuanabie. 

The inaxnteuance of ‘real‘ timers has oeen chaii 9 ed to reduce 
the overheau involved. assentialiy, a chained list ot ail 
■users With ‘real* timers is laaintaiued. The list is ordered 
by the users virtual timer value. Thus, the user at the top 
or the last expects a timar interrupt rirst. A binary ciocK 
(BINCLOCK) value is marntained ^y CP-67 to account for ail 
time, CPU and i^ait. This value is compared to tne 'real® 
timer value at the top of the irst. When an xnterrupt is 
indicated, CP processes it by tne usual virtual PSM swap. 
The routines used to mdintaia the time-or-day clock, the 
binary cIock ana to schedule 'coal* timers are placed in a 
new module called SCriEbULE that rafeceuceu by DISPATCH, 

DISPATCH now maintains two rmite lists or runnable users; 
users runnanle and ’eii-^ibie, and users runnable but net 
eiiyinie® A runnable user rs a user not lu I/O pagewait or 
console function wait, and not in virtual wait state, and 
whose running parameters {CPU time, priviiegea ratio, page 
demands, etc.) combined,-coarorm to fit witnin certain system 
restraints. These system restraints are imposed depending 
upon the siystem gonfiguration, certain operating parameters 
and the user activity. Interactive - users are primarily 
limited by a maxiumum uumoer aiiowed to be eligible. Compute 
and I/O users are limitea by a paging activity index. Each 
user has a paging activity .index caicuiated from such values 
as number of pages la core, number of page reads performed 
and the ratio of CP to user CPU time used. This paging 
activity index is then used iii conjunction with a system 
paging activity threshold to determine if cue limit has teen 
reached. If the system load will accommodate the increased 
paging activity according to the user index, then the user is 
considered runnable. an elr-jibie user is a use'r in pagenait, 
I/O wait or virtual machrue wait state enabled for an 
operating channel and waose running cuaracteristics 
(interactive or paging activity inaex) do not exceed system 
restraints, when made ruuuable. Some users will occasionally 
be neither runnable nor eligible, tor instance, a user in 
console function wait. The movement of users through the 
various states is a function ui CPU time used and other 
operating characteristics of tne virtual machine, . 


10. SCAN elimination _ 

Previous versions or cP-o7 used a SCAN ma'cro in several 
places CO generate code used to search chained lists fer 
particular conditions, Tne macro generated an SLT 
instruction which is avaiianie as a hardware HPy, for models 
without the EPC, executron caused a program interrupt that 
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iiivcked a iiottwate simuiatiou oi Llie 6Li' intitLuc tioii. It was 
doteLifliuea that xu maa^ cases a projxamiued instruction loop 
was more erticient tnaa the aLT iustructioa executxou, and 
certaiuiy more etticxeut .than the simuiatioa. Version 3,C of 
CP-fa7 eliiBxnatea much or the SCAN macro usaye. Version 3,1 
Will eiiminate aii usa^e ot the macro. Since the SLT 
instruction is uon-privxiedyea, those luachxu^s equipped with 
it will still £ unction lor tne users that wish to use it in 
problem prcgrams. 


11. DIAGNOSE disk I/O 

Since a large percentage or CMS disk 1/0 activity consists ct 
a Simple CCh string to read or wrrte Siy nytes, a more 
compact method was cuosea to support this operation to reduce 
I/O overhead. CMS ouiids its disk CCW string in the normal 
manner supplying ail arguments and , oufter addresses and then 
issues a ‘’diagnose” op-code instead ol a SIO, CP~67 
intercepts the diagnose, puilas a CCw strixig from a prototype 
and performs the I/O operation. Upon completion ot the disk 
1/0, CP returns a conaition coae to CMS ana then CMS may 
Continue to run. CMS avoids the overhead of CCWThANS, IPSW 
and I/O interrupt nandiiug. Error recovery is performed by 
CMS in the normal (SIO) ’fashion. 

■ . ■ ' 

12. Dynamic page release. ‘ 

Version 3.0 ox CP-67 uses dynamic page aiiocatioa ror the 
assignment of auxiiiary swapping space on arums and disks. 
Under many conditions (such as editing a trie or a lOKIhAN 
compilation), CMS uses a large portion of its user space. 
This space is always changed and hence swapped to auxiiiary 
storage. it is possible tnat those pages may not be 
referenced for some period or ■Lime, CMS uas thus impiemented 
a “diagnose” function to interface to CP-67 tor t,he purpose 
of .releasing those pages no longer reguirt:d, usually from 
1 * 12000 ' to X*3DOOO* liiciusive, Tnis diagnose frees pages in 
core (if any) and any pages assigned to swapping space. It 
has the advantage or shrinking the swapping space in use at 
the completion ol CMS ruuctions rather than at re-ipi or user 
LOGOUT. Certain CMS commands (lOAD and execution) cannot, of 
course, release the pages used, i.'Ut these commands are in the 
minority. For the most part, CMS communicating to CP-67 via 
diagnose which pages can be dynamicaiiy released shcuid 
improve the utilization of dynamic DASD paging space. 


13, System and user statistics 


0^^ 


Version 3.0 of CP-67 proviaes for some basic statistical 
gathering to detefsine system activity and provide basic user 
accounting information. Version 3.1 is extending, these 
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otatistiCo tc ptoviue some mure uiedninytai liatci revjardiny 
oystem utilizatioii dim mure cuasrsteut user statistics, tor 
system measurement, the roiiotfin 9 data is ueing added to 
version 3,1: 

- virtual SIO counts 

- virtual ''spooiiny” SiO count 

- “Uiagnose" 1/d reguests 

- max pages aiiocated to i>A3D 

• ~ spoci bufiers aiiocated 

- user privileged instruction execution 

For user measurement, tne xoilowing data is ueing added; 

- virtual SIO counts 

- spool ‘‘cards’* punched 

- spool “lines’* printed 

- spool “cards'* teau 

- pages read , ■ 

~ pages written , 

- T”disk ailocatiua 


improved PhCGIN'f ' 

Since much of the code in PdUuii'iT used ro checK for fast 
re-dispatch was duplicated in DlSPAl'Cli, it nas been removed 
and replaced by a direct trauster to UiSPATCH since the 
improved biSPAIC'il moaule can now guiCK.ly determine a 
machine's eligibility to run. • 

The code in PEOGllii’ tnat dealt with the handling of 
privileged instruction siumiation has neen split into a new 
module for addressability purposes. This module, PEIVLGliD, 
contains the code to petiorm detection or virtual machine 
privileged operations ana to cither periorm ,the required 
simulation or invcxe tne moduli, (ior example, yiObXlC) to 
periorm the simulaticn. 


Multiple page read/writes. 

The allocation table in core lor 2301 paging devices has teen 
extended by nine words. Each word acts as an ancnor point 
for a chain of paging tasks; one word tor each of nine 
records per pair of drum tracxs. head or write re guests for 
a particular record are rormed into a paging task (lOTASK, 
contrci and CCW's) anu chained on tne appropriate aiiocaticn 
word, if the speciiied drum is running, no rur.ther action is 
taken until an interrupt is presented. If the specified drum 
is avaiianle or it paging tasks are already chained, the new 
paging task is chained with others if tnat record is not 
already scheduled tor an I/O operation. Up to nine paging 
tasks can be chained together for one i/0 operation. Paging 
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tdsks are de-yueutid ana caaiuod tojouatir ii poiiiiiui*? alter 
processiii^ an luterrupt ri oui a u aperatin«j aruiii. I'laaiGy 1 
and 2 snow hoy pa>jiii^- tasKi> are >jueued. 


,16. ilisceilaneous chaui^es 

In version 3,0 of CP-87, cpxiiii’ buiit a chdiiieci list oi 200 
save areas each 24 Hords ru size, rhis numher was increased 
dynamicaliy alter a certain uumber of users ioyyed into the 
system. Since tne number was arOitrary, a iar-^e amount of 
storage was unnecessarriy used ror save areas, heiedse 3.1 
Starts With cniy 3 5 save areas and iacreases tiie number upon 
demand (not number or users), Tne additionai save areas are 
obtained troa the fhES storage sus-pooi for tne desired size. 
The save areas are also maintained in a '’pushdown” list 
instead of a ”wrap”diouud” cnaiii. 

A iiew luoduie called sCiidbaX resiaes iu low core and contains 
10 bytes of system creatiOii date. These 10 bytes (ter 
example, 03/24/71) are appended to tne iiiitiai CP-67 message 
•CP-67 VhHSIOh X LEVEL y',' 

The code in PAGTSAIJS for PAGdriAHE, PAGFhLr and PAGOUT has 
been split into a separate module, PAGTH, ror addressabiJity 
reasons. 


17. Serviceability functions 

Several lunctxoas have been revised or added to improve 
serviceability to tae system. The module CFS08C has been 
cewrittea to improve the formats aad functions of DiSPlAX, 
DUiaP, DCP, UUCP, STOfiE and sTcP. DISPLAY can now be 
performed with translation and storage keys can oe displayed. 
The "CP-87/CdS User's Guide” contains a complete command 
description, 

A new function caned "s^UEEY VIRTUAL” has been added to 
interrogate the virtual machine configuration. The 

information provided gives uevice status aad aiiocation data. 

In order to assist iu virtual muchiue problem determination, 
a trace and address stop ruiiction has been provided. The 
trace function can trap variou; interrupts and cptionally 
trace all instructions and viLtual and real CCkl's on a 
virtual SiO, The address stop can trap instruction 
execution. 







